home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / pm-utils / README.debugging < prev    next >
Text File  |  2009-10-06  |  2KB  |  48 lines
  1. End-user customization and debugging:
  2.  
  3. * If a particular hook is causing problems on your system, you can disable it
  4.   using the HOOK_BLACKLIST environment variable by creating a file in 
  5.   /etc/pm/config.d and adding the line:
  6.   HOOK_BLACKLIST="hookname 99another-hook"
  7.  
  8. * If a parameter (or lack thereof) passed to pm-suspend and friends is causing
  9.   problems, or you need to debug the suspend/resume process to work out what 
  10.   quirks are causing problems, you can use the ADD_PARAMETERS and 
  11.   DROP_PARAMETERS environment variables.  To do this, create a file in 
  12.   /etc/pm/config.d, and add the following lines to it:
  13.   ADD_PARAMETERS="--parameter-to-add --another-parameter"
  14.   DROP_PARAMETERS="--parameter-to-drop --another-parameter-to-drop"
  15.  
  16.   If you want to drop all parameters (for testing purposes, or to work around 
  17.   bugs in HAL), you can use DROP_PARAMETERS="all"
  18.  
  19. * If you suspect that a kernel module is preventing you from being
  20.   able to suspend and resume, you can use the SUSPEND_MODULES
  21.   environment variable to have that module removed when the system
  22.   suspends and reloaded when the system wakes up.
  23.  
  24. * If your clock drifts across a sleep/wake cycle, you can use 
  25.   NEED_CLOCK_SYNC="true" to force pm-utils to synchronize clocks.
  26.   This is a change in the default behaviour of pm-utils -- 1.2.2.1 and earlier
  27.   always synchronized clocks, but doing so is slow and most hardware stays in
  28.   sync without assistance.
  29.  
  30. * To find out what parameters can be passed to pm-suspend and friends, run them
  31.   with '--help' as the first parameter as root.  This will print out the 
  32.   options that it supports and which hooks or modules handle those options.
  33.  
  34. Significant conceptual changes from pm-utils 0.99.x and earlier:
  35.  
  36. * Do not rely on the internals of hooks when configuring or customizing
  37.   pm-utils.  Conceptually, hooks are black boxes from the point of view
  38.   of the pm-utils core code, and there is no guarantee that the implementation
  39.   of a given hook will not change from pm-utils revision to pm-utils revision.
  40.  
  41. * The preferred method of modifying the behaviour of a hook is to modify the
  42.   ADD_PARAMETERS and DROP_PARAMETERS to change the global parameters available
  43.   to each hook.
  44.  
  45. * All scripts created and maintained by the pm-utils are POSIX/SuS compliant.
  46.   Any modification or new script should be POSIX compliant and work as intended
  47.   using dash and posh before you submit a patch upstream.  
  48.